Home Memory Studio MCP setup

English

Using the ZIP edition

Extract the entire ZIP into a permanent local folder you can write to, for example %LOCALAPPDATA%\Programs\Home Memory Studio. Start HomeMemoryStudio.exe from that folder to use the desktop, or give the setup request below to your local assistant together with the full extraction path. No MSI installation or administrator rights are needed for this deployment. Keep databases and linked files outside the application folder. The ZIP does not create shortcuts or register .scd files with Windows. Windows security checks still apply to unsigned programs.

For an update, finish all AI requests and close Studio and its MCP process first. Back up your database and linked files. Extract the new version into a new folder, then update the MCP command path and any shortcuts after checking that it works. Do not merge different application versions or delete your data when removing an old application folder. User settings are stored separately in your Windows profile; this is an installation-free edition, not a fully self-contained USB workspace.

Guided setup

If your local AI assistant can access files and run programs on this Windows PC, give it this request. Studio and its MCP are already installed or extracted; the assistant does not need to download another server. With the ZIP edition, provide the full extraction path. In the request below, "installed" also includes this extracted application folder. Use its executables instead of the default MSI paths in the examples.

Set up the installed Home Memory Studio for this local AI client. First check for an existing Studio database, MCP entry, and documentation skill. Preserve existing databases and unrelated client settings. Use a database I explicitly identify, or create a new one at a previously unused local .scd path with the installed HomeMemoryStudio.exe --create-database command. Use --content-language=en unless I request German, then use --content-language=de. Wait for the creation process to finish, check its exit code and confirm the new file exists before configuring MCP. Never overwrite a database or silently choose an existing one. Configure this client to run the installed MCP\HomeMemoryStudioMCP.exe with HOME_MEMORY_STUDIO_DB_PATH pointing to that database. If this client supports Agent Skills, install the bundled MCP\skills\home-memory-studio-documentation as a user skill; otherwise continue without it. Close Studio before accessing the same database through MCP. Verify that MCP can read the database; if it is newly created, also confirm that its initial example structure is present. An empty result from an existing database is not a connection error. Then ask me for one real item, document it, find it again, and show me how to open the database in Studio. Ask only if a real choice, conflict, or required system approval remains. Report the database path, skill status, and any restart needed.

Manual setup

1. Create or open a .scd database in Home Memory Studio.
   Alternatively, create a new one without opening the desktop:
   PowerShell:
   & 'C:\Program Files (x86)\impact software\Home Memory Studio\HomeMemoryStudio.exe' --create-database 'C:\path\to\new-database.scd' --content-language=en | Out-String
   if ($LASTEXITCODE -ne 0) { throw "Database creation failed with exit code $LASTEXITCODE" }
   if (-not (Test-Path -LiteralPath 'C:\path\to\new-database.scd')) { throw 'Database file was not created' }
   If you chose another installation folder, use HomeMemoryStudio.exe from that folder.
   Use --content-language=de for German initial data. This command never overwrites an existing file.
   Close Studio before the MCP uses this database.
2. In your MCP compatible AI client, add a local stdio server.
3. Use HomeMemoryStudioMCP.exe from the MCP folder below the selected installation folder as the command.
4. Set HOME_MEMORY_STUDIO_DB_PATH to the full path of the .scd database you want to use.

Default command path:
C:\Program Files (x86)\impact software\Home Memory Studio\MCP\HomeMemoryStudioMCP.exe

Required environment variable:
HOME_MEMORY_STUDIO_DB_PATH=C:\path\to\your-database.scd

The MCP server needs no command line arguments and no separate Firebird or .NET installation. To use another database later, change HOME_MEMORY_STUDIO_DB_PATH in your MCP client configuration and restart that server process. The installer does not change any AI client configuration. The optional documentation skill is in MCP\skills\home-memory-studio-documentation; MCP also works without it.

Codex

Add this server to your user configuration at ~/.codex/config.toml. TOML literal strings use single quotes, so the Windows backslashes below do not need escaping.

[mcp_servers.home_memory_studio]
command = 'C:\Program Files (x86)\impact software\Home Memory Studio\MCP\HomeMemoryStudioMCP.exe'
args = []

[mcp_servers.home_memory_studio.env]
HOME_MEMORY_STUDIO_DB_PATH = 'C:\Users\YOUR_NAME\Documents\Home Memory Studio\HomeMemoryStudio.scd'

Save the file, then restart the MCP server in Codex. In the ChatGPT desktop app, open Settings, select MCP servers, and select Restart for this server.

Claude Desktop

Add the following entry to the mcpServers object in claude_desktop_config.json. If the file already contains other servers, merge this entry instead of replacing the complete file. JSON requires each Windows backslash to be written twice.

{
  "mcpServers": {
    "home-memory-studio": {
      "type": "stdio",
      "command": "C:\\Program Files (x86)\\impact software\\Home Memory Studio\\MCP\\HomeMemoryStudioMCP.exe",
      "args": [],
      "env": {
        "HOME_MEMORY_STUDIO_DB_PATH": "C:\\Users\\YOUR_NAME\\Documents\\Home Memory Studio\\HomeMemoryStudio.scd"
      }
    }
  }
}

Save the configuration and fully restart Claude Desktop so it starts the server with the new setting.

Firebird Embedded may allow only one process at a time to use the database. If the MCP reports that the database is in use, close Home Memory Studio and retry the MCP call. You do not need to restart the MCP server.

Deutsch

ZIP-Ausgabe verwenden

Entpacken Sie das gesamte ZIP in einen dauerhaften lokalen Ordner mit Schreibzugriff, zum Beispiel %LOCALAPPDATA%\Programs\Home Memory Studio. Starten Sie dort HomeMemoryStudio.exe für den Desktop oder geben Sie Ihrem lokalen Assistenten den folgenden Einrichtungsauftrag zusammen mit dem vollständigen Entpackpfad. Für diese Bereitstellung sind weder eine MSI-Installation noch Administratorrechte erforderlich. Speichern Sie Datenbanken und verknüpfte Dateien außerhalb des Programmordners. Das ZIP erstellt keine Verknüpfungen und registriert keine .scd-Dateien in Windows. Windows-Sicherheitsprüfungen gelten weiterhin auch für unsignierte Programme.

Beenden Sie vor einem Update alle KI-Anfragen und schließen Sie Studio sowie seinen MCP-Prozess. Sichern Sie Ihre Datenbank und verknüpften Dateien. Entpacken Sie die neue Version in einen neuen Ordner und passen Sie nach erfolgreicher Prüfung den MCP-Befehlspfad und etwaige Verknüpfungen an. Vermischen Sie keine Programmversionen und löschen Sie beim Entfernen alter Programmordner keine Nutzerdaten. Benutzereinstellungen liegen separat im Windows-Profil; dies ist eine Ausgabe ohne Installation, kein vollständig eigenständiger USB-Arbeitsplatz.

Geführte Einrichtung

Wenn Ihr lokaler KI-Assistent auf Dateien und Programme dieses Windows-Rechners zugreifen kann, geben Sie ihm diesen Auftrag. Studio und sein MCP sind bereits installiert oder entpackt; ein zusätzlicher Server-Download ist nicht nötig. Geben Sie bei der ZIP-Ausgabe den vollständigen Entpackpfad mit. Im folgenden Auftrag umfasst "installiert" auch diesen entpackten Programmordner. Verwenden Sie dessen Programme anstelle der MSI-Standardpfade in den Beispielen.

Richte das installierte Home Memory Studio für diesen lokalen KI-Client ein. Prüfe zuerst, ob schon eine Studio-Datenbank, ein MCP-Eintrag und der Dokumentationsskill vorhanden sind. Erhalte bestehende Datenbanken und andere Client-Einstellungen. Verwende eine von mir ausdrücklich benannte Datenbank oder erstelle eine neue unter einem noch freien lokalen .scd-Pfad mit dem installierten Befehl HomeMemoryStudio.exe --create-database. Verwende --content-language=de, sofern ich nicht Englisch wünsche; dann verwende --content-language=en. Warte das Ende des Erstellungsprozesses ab, prüfe seinen Exitcode und bestätige die neue Datei, bevor du MCP einrichtest. Überschreibe niemals eine Datenbank und wähle keine bestehende selbst aus. Richte in diesem Client die installierte MCP\HomeMemoryStudioMCP.exe ein und setze HOME_MEMORY_STUDIO_DB_PATH auf diese Datenbank. Falls der Client Agent Skills unterstützt, installiere den mitgelieferten Skill MCP\skills\home-memory-studio-documentation für den Benutzer; fahre andernfalls ohne Skill fort. Schließe Studio, bevor der MCP dieselbe Datenbank verwendet. Prüfe, ob MCP die Datenbank lesen kann; prüfe bei einer Neuanlage zusätzlich die anfängliche Beispielstruktur. Ein leeres Suchergebnis aus einer bestehenden Datenbank ist kein Verbindungsfehler. Frage mich dann nach einem echten Gegenstand, erfasse ihn, finde ihn wieder und zeige mir, wie ich die Datenbank in Studio öffne. Frage nur bei einer echten Entscheidung, einem Konflikt oder einer erforderlichen Systemfreigabe nach. Nenne mir Datenbankpfad, Skill-Status und einen nötigen Neustart.

Manuelle Einrichtung

1. Erstellen oder öffnen Sie eine .scd-Datenbank in Home Memory Studio.
   Alternativ können Sie ohne Desktopfenster eine neue Datenbank erstellen:
   PowerShell:
   & 'C:\Program Files (x86)\impact software\Home Memory Studio\HomeMemoryStudio.exe' --create-database 'C:\Pfad\zur\neuen-Datenbank.scd' --content-language=de | Out-String
   if ($LASTEXITCODE -ne 0) { throw "Datenbankerstellung fehlgeschlagen, Exitcode $LASTEXITCODE" }
   if (-not (Test-Path -LiteralPath 'C:\Pfad\zur\neuen-Datenbank.scd')) { throw 'Datenbankdatei wurde nicht erstellt' }
   Falls Sie einen anderen Installationsordner gewählt haben, verwenden Sie die HomeMemoryStudio.exe aus diesem Ordner.
   Für englische Anfangsdaten verwenden Sie --content-language=en. Der Befehl überschreibt keine bestehende Datei.
   Schließen Sie Studio, bevor der MCP diese Datenbank verwendet.
2. Fügen Sie in Ihrem MCP-kompatiblen AI-Client einen lokalen stdio-Server hinzu.
3. Verwenden Sie HomeMemoryStudioMCP.exe aus dem MCP-Ordner unterhalb des gewählten Installationsordners als Befehl.
4. Setzen Sie HOME_MEMORY_STUDIO_DB_PATH auf den vollständigen Pfad der gewünschten .scd-Datenbank.

Standardpfad des Befehls:
C:\Program Files (x86)\impact software\Home Memory Studio\MCP\HomeMemoryStudioMCP.exe

Erforderliche Umgebungsvariable:
HOME_MEMORY_STUDIO_DB_PATH=C:\Pfad\zu\Ihrer-Datenbank.scd

Der MCP-Server benötigt keine Befehlszeilenargumente und keine separate Firebird- oder .NET-Installation. Um später eine andere Datenbank zu verwenden, ändern Sie HOME_MEMORY_STUDIO_DB_PATH in der MCP-Client-Konfiguration und starten Sie diesen Serverprozess neu. Der Installer verändert keine KI-Client-Konfiguration. Der optionale Dokumentationsskill liegt unter MCP\skills\home-memory-studio-documentation; der MCP funktioniert auch ohne ihn.

Codex

Fügen Sie den oben gezeigten Codex Block in Ihre Benutzerkonfiguration unter ~/.codex/config.toml ein. Einfache Anführungszeichen erzeugen in TOML eine Literalzeichenfolge, deshalb werden die Windows-Backslashes nicht verdoppelt. Speichern Sie die Datei und starten Sie danach den betreffenden MCP-Server in Codex neu. In der ChatGPT Desktop-App öffnen Sie Einstellungen, wählen MCP-Server und danach für diesen Server Neu starten.

Claude Desktop

Fügen Sie den oben gezeigten JSON Eintrag in das vorhandene mcpServers Objekt in claude_desktop_config.json ein. Überschreiben Sie keine bereits vorhandenen Servereinträge. In JSON muss jeder Windows-Backslash doppelt geschrieben werden. Speichern Sie die Konfiguration und starten Sie Claude Desktop vollständig neu.

Firebird Embedded erlaubt möglicherweise nur einem Prozess gleichzeitig den Zugriff auf die Datenbank. Falls MCP meldet, dass die Datenbank verwendet wird, schließen Sie Home Memory Studio und wiederholen Sie den MCP-Aufruf. Ein Neustart des MCP-Servers ist nicht erforderlich.

Advanced / Fortgeschritten

SMARTCONSTRUCT_DB_PATH remains available as a legacy alias if HOME_MEMORY_STUDIO_DB_PATH is not set. When both are set, HOME_MEMORY_STUDIO_DB_PATH takes precedence. HOME_MEMORY_DB_PATH is not accepted as a public fallback.

Verified syntax references:
https://developers.openai.com/codex/mcp/
https://code.claude.com/docs/en/mcp
